Vibe Coding 的新手體驗 - Antigravity
TLDR
- 配額機制：Antigravity 的模型配額與網頁版 Gemini 分開計算，但進階模型配額有限且改為週重置，建議依需求選擇 Pro 或 Ultra 方案。
- 操作核心：透過
Antigravity Cockpit監控額度，並利用Planning模式取代Fast模式，以確保 AI 在執行前先產生計畫供人審核。 - 權限控管：建議將
Review Policy設定為Request Review，特別是涉及終端機指令與瀏覽器操作時，以避免誤刪檔案或執行危險腳本。 - 背景知識注入：透過在專案根目錄或子目錄建立
GEMINI.md，可強制 Agent 遵循特定的 Commit 規範或開發規則。 - 常見地雷：AI 可能會因快照機制導致檔案回溯、編碼錯誤（如 PowerShell 處理中文亂碼）、產生殘餘檔案，以及在 CSS 調整上陷入「修好 A 壞了 B」的循環。
- 核心建議：Vibe Coding 不代表可以「把腦丟掉」，使用者的技術底蘊決定了程式碼品質的下限，務必對 AI 產出的程式碼進行 Review。
Antigravity 核心設定與操作
Antigravity 基於 Code OSS 建構，介面與 VS Code 高度相似。使用時應注意以下核心功能：
1. 額度管理與監控
安裝 Antigravity Cockpit 擴充套件後，可於右下角查看各模型剩餘額度。
- 獨立計算：Antigravity 的額度池與網頁版 Gemini 是分開計算的，不會互相影響。
- 權重差異：同一個額度群組內的模型，消耗額度的權重並不相同。
2. Agent 行為與權限設定
透過 Settings => Open Antigravity User Settings 調整 Agent 的自主權：
- Review Policy：建議設定為
Request Review，確保 AI 執行計畫前需經由人類批准。 - Browser Tools：若涉及金流或外部介接，
Browser Javascript Execution Policy務必設為Request Review。 - 對話模式：建議使用
Planning模式，AI 會先產生執行計畫報告，比Fast模式更穩健。
3. 背景資訊注入 (GEMINI.md)
透過建立 GEMINI.md 檔案，可提供 Agent 背景資訊，強制其參考特定規範。
- 繼承規則：Agent 會從當前工作目錄逐層向上查找至專案根目錄或主目錄。
- 優先級：更具體的檔案（如子目錄中的
GEMINI.md）內容會覆寫或補充更一般的檔案內容。 - 應用場景：適合用來鎖定 Commit 規範或定義專案開發規則。
實際應用案例
1. 檔案系統自動化處理
在處理如「圖片遷移」或「框架轉換」等繁瑣任務時，Antigravity 可直接讀取檔案系統並進行批次修改。
- 什麼情況下會遇到：當需要對大量 Markdown 檔案進行格式統一、連結替換或資料補全時。
- 建議做法：先讓 Agent 讀取現有檔案結構，確認執行計畫後再進行批次操作。
2. 瀏覽器自動化測試
透過 Antigravity Browser Control 擴充套件，可操控瀏覽器進行 End-to-End 測試。
- 什麼情況下會遇到：需要驗證網頁功能或進行自動化點擊測試時。
- 注意事項：此功能會額外消耗 Gemini Flash 模型額度，且對於 CSS 樣式問題的判斷能力有限，建議僅用於邏輯測試。
踩雷紀錄與技術建議
在使用 Vibe Coding 過程中，應特別留意以下潛在風險：
1. 快照與 Git 衝突
- 問題情境：在 Agent 工作期間手動使用 Git 修改檔案。
- 原因分析：Antigravity 的快照機制可能導致舊內容覆蓋新變更。
- 建議做法：在 Agent 執行任務期間，盡量避免手動進行 Git 操作。
2. 編碼與腳本偏好
- 問題情境：使用 PowerShell 處理中文檔案時出現亂碼。
- 原因分析：不同模型（Gemini 偏好 Python，Claude 偏好 PowerShell）對編碼處理的預設行為不同。
- 建議做法：明確要求 Agent 使用編碼安全的方式處理檔案，並在執行後檢查 Git Diff。
3. 殘餘檔案與技術債
- 問題情境：根目錄產生大量臨時腳本或 txt 檔案。
- 建議做法：將這些檔案加入
.gitignore，並在 AI 產出程式碼後，務必檢查是否將邏輯提取為共用常數，避免產生技術債。
4. 幻覺 (Hallucination)
- 問題情境：AI 提供錯誤的網址或瞎掰官方資訊。
- 建議做法：對於關鍵資訊，務必自行查證，不要完全依賴 Agent 的搜尋結果。
異動歷程
- 初版文件建立。
- 補充 GEMINI.md 的作用範圍、繼承關係說明及測試方法。
- 補充 Google 於 2026-03-12 調整 Antigravity 配額機制的相關說明。